home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 001-100 / 001-025 / 003 / roff / tpr.man < prev    next >
Text File  |  1995-03-17  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4.      TTTTPPPPRRRR((((1111))))                   UUUUNNNNIIIIXXXX 5555....0000 ((((4444////88882222))))                   TTTTPPPPRRRR((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           tpr - text processor
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ttttpppprrrr [ ooooppppttttiiiioooonnnnssss ] ffffiiiilllleeee ............
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           TTTTpppprrrr formats text according to control lines embedded in the
  16.           text in the given files or standard input if none is
  17.           specified.  Input consists of intermixed _t_e_x_t _l_i_n_e_s, which
  18.           contain information to be formatted, and _r_e_q_u_e_s_t _l_i_n_e_s,
  19.           which contain instructions about how to format it.  Request
  20.           lines begin with a distinguished _c_o_n_t_r_o_l _c_h_a_r_a_c_t_e_r, normally
  21.           a period.  Output lines may be _f_i_l_l_e_d as nearly as possible
  22.           with words without regard to input lineation.  Line _b_r_e_a_k_s
  23.           may be caused at specified places by certain commands, or by
  24.           the appearance of an empty input line or an input line
  25.           beginning with a space.
  26.  
  27.           The capabilities of ttttpppprrrr are specified in the attached
  28.           Request Summary.  Numerical values are denoted there by n or
  29.           +n, titles by t, and single characters by c.  Numbers
  30.           denoted +n may be signed + or -, in which case they signify
  31.           relative changes to a quantity, otherwise they signify an
  32.           absolute resetting.  Missing n fields are ordinarily taken
  33.           to be 1, missing t fields to be empty, and c fields to shut
  34.           off the appropriate special interpretation.
  35.  
  36.           Running titles usually appear at top and bottom of every
  37.           page.  They are set by requests like
  38.  
  39.                     .he 'part1'part2'part3'
  40.  
  41.           Part1 is left justified, part2 is centered, and part3 is
  42.           right justified on the page.  Any % sign in a title is
  43.           replaced by the current page number.  Any nonblank may serve
  44.           as a quote.
  45.  
  46.           The options currently available are:
  47.  
  48.           dddd         print directives encountered in input on
  49.                     diagnostic output (debugging only).
  50.  
  51.           eeeeffffiiiilllleeee     divert error messages to file.
  52.  
  53.           iiii[[[[iiiinnnnddddeeeexxxx]]]]  open the index file (see .rf directive), default
  54.                     name is index.
  55.  
  56.           nnnnNNNN        number first page N (default 0).
  57.  
  58.           ssssNNNN        stop after every N pages (default 1) and wait for
  59.                     newline from terminal iff output is to terminal
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 12/28/85)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      TTTTPPPPRRRR((((1111))))                   UUUUNNNNIIIIXXXX 5555....0000 ((((4444////88882222))))                   TTTTPPPPRRRR((((1111))))
  71.  
  72.  
  73.  
  74.                     device.  There is no initial pause.
  75.  
  76.           In addition, - in the input file list indicates that
  77.           standard input is to be opened and read.
  78.  
  79.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  80.           Of course!
  81.  
  82.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  83.           nroff(1), troff(1)
  84.  
  85.      AAAAUUUUTTTTHHHHOOOORRRR
  86.           Many people have worked on the ancestors of ttttpppprrrr,,,, known by
  87.           names such as runoff, roff, etc.  Ken Yap ( University of
  88.           Sydney ) can only claim credit for rewriting it in C.
  89.  
  90.      BBBBUUUUGGGGSSSS
  91.           TTTTpppprrrr may produce output too rapidly for people used to slower
  92.           formatters.
  93.  
  94.           Although ttttpppprrrr is written in C, it will probably be utterly
  95.           frozen because of the archaic convention of control lines
  96.           and text lines and paucity of structured directives.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 12/28/85)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      TTTTPPPPRRRR((((1111))))                   UUUUNNNNIIIIXXXX 5555....0000 ((((4444////88882222))))                   TTTTPPPPRRRR((((1111))))
  137.  
  138.  
  139.  
  140.                               REQUEST SUMMARY
  141.  
  142.      _R_e_q_u_e_s_t    _B_r_e_a_k  _I_n_i_t_i_a_l _M_e_a_n_i_n_g
  143.      .ad        yes    yes     Begin adjusting right margins.
  144.      .ar        no     arabic  Arabic page numbers.
  145.      .br        yes    -       Causes a line break - the filling of
  146.                                the current line is stopped.
  147.      .bd n      no     -       Bold the printable characters in the
  148.                                next n lines.
  149.      .bl n      yes    -       Insert of n blank lines, on new page if
  150.                                necessary.
  151.      .bp +n     yes    n=1     Begin new page and number it n; no n
  152.                                means +1.
  153.      .cc c      no     c=.     Control character becomes c.
  154.      .ce n      yes    -       Center the next n input lines, without
  155.                                filling.
  156.      .de xx     no     -       Define parameterless macro to be
  157.                                invoked by request .xx (definition ends
  158.                                on line beginning ........).
  159.      .ef t      no     t=      Even foot title becomes t.
  160.      .eg        no     arabic  English page numbers.
  161.      .eh t      no     t=      Even head title becomes t.
  162.      .fi        yes    yes     Begin filling output lines.
  163.      .fo t      no     t=      All foot titles are t.
  164.      .he t      no     t=      All head titles are t.
  165.      .in +n     yes    -       Indent n spaces from left margin.
  166.      .ix +n     no     -       Same as .in but without break.
  167.      .li n      no     -       Literal, treat next n lines as text.
  168.      .ll +n     no     n=65    Line length including indent is n
  169.                                characters.
  170.      .ls +n     yes    n=1     Line spacing set to n lines per output
  171.                                line.
  172.      .m1 n      no     n=3     n-1 blank lines put between the top of
  173.                                page and head title.
  174.      .m2 n      no     n=1     n blank lines put between head title
  175.                                and beginning of text on page.
  176.      .m3 n      no     n=1     n blank lines put between end of text
  177.                                and foot title.
  178.      .m4 n      no     n=3     n-1 blank lines put between the foot
  179.                                title and the bottom of page.
  180.      .na        yes    no      Stop adjusting the right margin.
  181.      .ne n      no     -       Begin new page, if n output lines
  182.                                cannot fit on present page.
  183.      .nf        yes    no      Stop filling output lines.
  184.      .of t      no     t=      Odd foot title becomes t.
  185.      .oh t      no     t=      Odd head title becomes t.
  186.      .pl +n     no     n=66    Total paper length taken to be n lines.
  187.      .po +n     no     n=0     Page offset.  All lines are preceded by
  188.                                n spaces.
  189.      .re +n     no     -       Restore environment n levels back.
  190.      .rf +n     no     n=1     Save the next n following lines in the
  191.                                index file with page number.
  192.  
  193.  
  194.  
  195.      Page 3                                         (printed 12/28/85)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      TTTTPPPPRRRR((((1111))))                   UUUUNNNNIIIIXXXX 5555....0000 ((((4444////88882222))))                   TTTTPPPPRRRR((((1111))))
  203.  
  204.  
  205.  
  206.      .ro        no     arabic  Roman page numbers.
  207.      .rp n      no     n=1     Output n blank pages at the next page
  208.                                break.  Page reservations are
  209.                                cumulative.
  210.      .se        yes    -       Save environment.  The environment
  211.                                consists of all current settings
  212.                                affected by the following directives:
  213.                                .ad, .ar, .bd, .bl, .cc, .ce, .ef, .eh,
  214.                                .fi, .fo, .he, .in, .ix, .li, .ll, .ls,
  215.                                .m1, .m2, .m3, .m4, .na, .ne, .nf, .of,
  216.                                .oh, .pl, .po, .ro, .sk, .sp, .ta, .tc,
  217.                                .ti, .ub, .ul.
  218.      .sk n      no     -       Produce n blank pages starting next
  219.                                page.
  220.      .so file   no     -       Include file file.
  221.      .sp n      yes    -       Insert block of n blank lines, except
  222.                                at top of page.
  223.      .ta n n..         9,17,.. Pseudotab settings.  Initial tab
  224.                                settings are columns 9 17 25 ...
  225.      .tc c      no     space   Tab replacement character becomes c.
  226.      .ti +n     yes    -       Temporarily indent next output line n
  227.                                spaces.
  228.      .ub c      no     ' '     Unpaddable blank is c.
  229.      .ul n      no     -       Underline the letters and numbers in
  230.                                the next n input lines.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 12/28/85)
  262.  
  263.  
  264.  
  265.